home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / EXP_VRML.1 < prev    next >
Encoding:
Text File  |  1996-07-27  |  4.6 KB  |  106 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Export-VRML
  3. .SH NAME
  4. exp_vrml \- VRML geometry export filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the VRML geometry
  8. export converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a 3D Studio file to VRML using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i 3ds -o vrml filename.3ds
  16. .PP
  17. To convert a Lightwave file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i lw -o vrml -out-output-texture-data = yes filename.lw
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. VRML is an ASCII file format for describing 3d scenes which is primary used
  25. in interactive virtual reality applications. This VRML geometry export 
  26. converter writes out the scene database to a VRML v1.0 compliant file.
  27. .PP
  28. Concave polygons and polygons with holes will be triangulated before 
  29. being output as indexed polygon primitives. Cameras, lights and
  30. material definitions will also be output in addition to the basic
  31. geometry. Since there is no ambient light type in the VRML specification
  32. the ambient light color is multiplied into each material's ambient color.
  33. .PP
  34. Normals and texture coordinates are bound on a per-vertex basis, while
  35. materials are bound on a per-face (per-polygon) basis. If multiple textures
  36. are assigned to a single object then that object will be exploded into separate
  37. indexed polygon primitives before being output to the VRML file, with
  38. each primitive being assigned a single texture.
  39. .PP
  40. Note that this converter does not allow anchors or inlines to be output
  41. along with the data. These commands can be inserted into the file
  42. manually.
  43. .PP
  44. As with all other export converters, the exported indexed polygons are
  45. automatically welded and optimized before being output to the VRML file.
  46. This optimization step includes removing redundant coordinates and 
  47. creating vertex normals if none exist. Thus, the exported geometry should
  48. be in a good, compact form for efficient VRML usage.
  49. .PP
  50. .SH COMMAND LINE OPTIONS
  51. .PP
  52. The following options are specific to this export converter:
  53. .TP
  54. -o vrml
  55. This is the mandatory command line option which specifies that the data
  56. is to be exported using the VRML format converter.
  57. .TP
  58. -out-vrml-file-version = [ 1 | 2 ]
  59. This selects what VRML file format to save the data into. '1' will output
  60. in the original VRML 1.0 format whereas '2' will output in the new 
  61. 'Moving Worlds' format.
  62. .TP
  63. -out-vrml-embed_texture_images = [ yes | no ]
  64. If this option is set to 'yes' and the '-out-output-texture-data' option
  65. is set to 'yes' then any texture images referenced by the VRML data will
  66. be embedded directly within the file. The converter can convert
  67. and embed the following file formats (and all of their variations): BMP, 
  68. FLIC, GIF, CEL (Autodesk), JPEG, Targa and TIFF.
  69. .TP
  70. -out-vrml-output-texture-data = [ yes | no ]
  71. If this option is set to 'yes' then texture mapping coordinates and
  72. references will be output to the VRML file for those primitives which 
  73. references 2d textures. If set to 'no' then no texture mapping related 
  74. information will be output. 
  75. .TP
  76. -out-vrml-add-url-prefix = [ yes | no ]
  77. If this option is set to 'yes' then all bitmap filenames (used in association 
  78. with a texture map) will be prefixed with the string specified by the 
  79. '-out-vrml-url-string' option below. For example, if a texture references the 
  80. filename 'c:/nugraf/textures/bitmap.tif' within the NuGraf database, and the 
  81. URL is specified on this dialog box as "http://www.okino.com/images/"
  82. then the bitmap filename will be stored in the VRML file as 
  83. 'http://www.okino.com/images/bitmap.tif'.
  84. .TP
  85. -out-vrml-url-string = "URL string goes here"
  86. This is the URL string that will be prefixed before any bitmap filenames in 
  87. the VRML file. You must enable the '-out-vrml-add-url-prefix' option above 
  88. for this string to take affect.
  89. .TP
  90. -out-line-ending = [ cr | lf | crlf ]
  91. This common option selects which line terminator is to be used for the ASCII output 
  92. file. Files destined for DOS/PC machines should use 'crlf', files for UNIX 
  93. machines should use 'lf' and files for Macintosh machines should use 'cr'.
  94. The default is specific to which machine this converter is presently running
  95. on: 'crlf' for DOS/PC, 'lf' for UNIX and 'cr' for Macintosh. This option
  96. normally does not have to be specified unless you will be using the exported
  97. ASCII file on a different type of computer.
  98. .PP
  99. .SH VRML SITES ON THE INTERNET
  100. .TP
  101. http://www.vrml.org
  102. Home site of VRML organization.
  103. .TP
  104. http://www.sdsc.edu/vrml
  105. Virtual Reality Modeling Language Repository.
  106.